home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / ek / hotdir72 / hotdir.doc < prev    next >
Encoding:
Text File  |  1992-10-15  |  9.5 KB  |  214 lines
  1. Documentation for HotDIR Plus 7.2 (DOS Evaluation Version)
  2.  
  3. Thank you for obtaining the User-Supported Version (i.e. Shareware)
  4. version of HotDIR Plus 7.2 for DOS.  HotDIR Plus is distributed under the
  5. User-Supported Software method.  You get to try the program before
  6. you buy it to make sure that it meets your needs.  How many times have you
  7. bought an expensive PC software package at your local software store only
  8. to find out it won't work like you wanted it to, or that it was a dud?  Well no
  9. more!   You are free to try HotDIR Plus 7.2 for up to 30 days from the date
  10. you received it.  If after using it you decide you would like to keep using it,
  11. you are required to register your copy.  See the file REGISTER.DOC for
  12. the registration form.  If you do not register HotDIR Plus after 30 days you
  13. must erase it from your PC and stop using it.  Also if you are interested in
  14. an OS/2 version of HotDIR Plus please download that shareware version
  15. to try it out, or order the registered OS/2 version from the author for only
  16. $5 more than the DOS version and you will get both the DOS and OS/2 versions.
  17.  
  18. For more information about HotDIR Plus or to register write to:
  19.  
  20. Robert Woeger
  21. 2423 Hagerman St.
  22. Colorado Springs, CO 80904   U.S.A.    Phone (719) 471-8306
  23.  
  24. HotDIR was the first and in my opinion the best color sorted directory
  25. utility.  I originally released version 1.0 back in early 1987, followed
  26. by the "famous" HotDIR 2.1.  Due to the change with hard disks larger than
  27. 33 MB in DOS 4 and DOS 5, I rewrote HotDIR from scratch and relased the
  28. HotDIR Plus 7.0 series.  HotDIR Plus 7.0 and 7.1 were only released to a
  29. few people and this is the first MAJOR release of HotDIR Plus now 7.2.
  30.  
  31. HotDIR Plus is a color sorted directory utility.  HotDIR Plus is unique in
  32. that it was the first to display files by color (based on what extension they
  33. were).  It has options to sort your files in many different ways, and list
  34. them left to right or up and down, plus in 1, 2, 4, or 6 column format.
  35. I believe that once you've tried HotDIR you'll be hooked.  Your files will
  36. "pop out" at you, and that is how the "Hot" in HotDIR came about.  I
  37. originally wrote HotDIR for a friend of mine, Dr. John German, to help him
  38. see the different files by type (extensions) easier.  He said, "that's Hot"!
  39. and I soon released the original HotDIR 1.0 to the world.  I got such an
  40. enthusiastic response from HotDIR that I wrote HotDIR Plus.  I hope you
  41. enjoy using it as much as we do.
  42.  
  43. Type: HDIRPLUS /h     to get the help screen.
  44.  
  45. All commands are described on the help screen and appear as a forward
  46. slash followed by a letter of the option.  You may use multiple commands
  47. when you invoke HDIRPLUS:
  48.  
  49. Format:    HDIRPLUS [path] [filespec] [/option] [/option] ...
  50.  
  51. Examples are:
  52.  
  53. HDIRPLUS \os2\system /c /2
  54.  
  55.         This will display a 2 column directory format and clear the screen
  56.         first.  It will display all files in directory \os2\system.
  57.  
  58. HDIRPLUS
  59.  
  60.         This will display all files in the default drive/directory and use the
  61.         predefined options.  Default or those modified through HDIRCNFG.EXE.
  62.  
  63. HDIRPLUS /r
  64.  
  65.         Information about registering your copy of HotDIR Plus.
  66.  
  67. HDIRPLUS /h
  68.  
  69.         List of all commands available for HotDIR Plus.
  70.  
  71. HDIRPLUS a: /p
  72.  
  73.         Display directory of A: drive and toggle Pause at end of screen mode.
  74.  
  75. HDIRPLUS /p >prn
  76.  
  77.         Sends HotDIR Plus' output to the printer without page pauses.
  78.         You can send output to a file by placing >filename instead of >prn.
  79.  
  80.  
  81. Summary
  82. -------
  83.  
  84. Commands used by HotDIR Plus:
  85.  
  86. /H - displays on-line help screen
  87. /R - displays information on how to register your copy
  88.  
  89. /N - No sort (unsorted raw file directory)
  90. /F - Filename sort (factory default)
  91. /E - Sort by extension
  92. /D - Sort by date (oldest to newest files)
  93. /S - sort by file size
  94.  
  95. /1 - 1 column display format
  96. /2 - 2 column display format
  97. /4 - 4 column display format (factory default)
  98. /6 - 6 column display format
  99.  
  100. /C - toggles Clear screen at beginning of directory display
  101. /P - Pause at end of screen toggle
  102. /U - Up/Down file sort/display toggle - alternate is left to right display
  103.  
  104. This summarizes the command switches for HotDIR Plus.
  105.  
  106.  
  107. A program names HDIRCNFG.EXE is included to give you greater flexibility
  108. and control over the permanent HotDIR Plus settings.  The above commands
  109. are great for overriding the default settings, but when you want to
  110. permanently change the colors used by HotDIR Plus, sort options, column
  111. displayed, etc. use HDIRCNFG to change HDIRPLUS.EXE.  HDIRCNFG.EXE
  112. modifies the HDIRPLUS.EXE program itself and writes the changes inside the
  113. HotDIR Plus program.  This was done to keep from having a separate
  114. configuration file for HotDIR Plus floating around.  Due to a programming
  115. error on my part HotDIR Plus 7.1 was clobbered whenever the HDIRCNFG program
  116. was run and the options saved.  This has now been fixed, but I encourage
  117. you to make a backup copy of HDIRPLUS.EXE before running the HDIRCNFG utility.
  118.  
  119. Simply run HDIRCNFG and it will prompt you to change each setting.  If you
  120. make a mistake just do not save the changes, exit HDIRCNFG, and rerun.
  121.  
  122. If you want to remove an extension name and color, simply overwrite the
  123. extension name with another extension and color.  If you want to just disable
  124. one extension make sure you use blanks for the extension name.  Make sure
  125. you move the other extensions forward and make the blank extension the last
  126. in the list.  Otherwise the blank extension will cause HotDIR Plus to stop
  127. searching for other colors and extensions that are after a blank entry.
  128.  
  129. HDIRCNFG is very versatile and powerful, but I recommend you get familiar
  130. with HDIRPLUS first before you change options.  Most every option is able to
  131. be changed through HDIRCNFG.EXE.  If you want to temporarily override an
  132. option use a command switch when invoking HotDIR Plus.  Also you can change
  133. the number of lines to display per screen with HDIRCNFG.  This is very useful
  134. for EGA & VGA monitors when in 43 or 50 line per screen mode.
  135.  
  136. HDIRCNFG uses standard BASIC COLOR command color numbers.  It is recommended
  137. that you use colors between 0 and 15.  16-31 are blinking versions of the
  138. lower 0-15 colors.  The most common colors numbers are:
  139.  
  140.         0       Black
  141.         1       Blue
  142.         2       Green
  143.         3       Cyan
  144.         4       Red
  145.         5       Magenta
  146.         6       Yellow
  147.         7       White
  148.         8       Gray
  149.         9       Light blue
  150.         10      Light green
  151.         11      Light cyan
  152.         12      Light red
  153.         13      Light magenta
  154.         14      Hi intensity yellow
  155.         15      Hi intensity white
  156.  
  157.  
  158. There are some self imposed limits with HotDIR Plus which are:
  159.  
  160. No more than 1,000 files per subdirectory.  This is a reasonable number
  161. of files, and it helps keep HotDIR's sort and data areas to a reasonable size.
  162.  
  163. File sizes up to 9,999,999 may be displayed without breaking HotDIR Plus'
  164. formatting on the screen.  I chose this number as most files are less than
  165. 10 megabytes in size each.  Note that the disk size may be over 1.6 gigabytes
  166. and HotDIR Plus should report the total disk free correctly.  Only each file
  167. is limited to a maximum of 10 megabytes.  If a file is greater than 10 megs,
  168. the file size should be displayed properly, but you will notice that since it
  169. takes extra digits to display, your 2,4, or 6 column HotDIR Plus display
  170. may "wrap around" on the line where that huge file is.  1 column displays
  171. will work best if you have alot of huge 10 meg+ files in a directory.
  172.  
  173.  
  174.  
  175. *** This is not free software!  You are granted a limited non-exclusive
  176. license to use this software (HDIRPLUS.EXE and HDIRCNFG.EXE) for a trial
  177. period of no longer than 30 days.  If after that time you have not paid for
  178. the right to use the program from the author, you must STOP using it.  You are
  179. free to distribute unmodified copies of the entire Shareware version of HotDIR
  180. Plus to others, but in no way may you charge any fee for HotDIR Plus other
  181. than a modest disk duplication fee not to exceed $8.  This documentation file
  182. and the REGISTER.DOC file MUST be distributed unmodified with HDIRPLUS.EXE
  183. and HDIRCNFG.EXE.  Registration is described by the REGISTER.DOC file and
  184. by the HDIRPLUS /r command.  The author, Robert Woeger, makes no warranties
  185. or guarantees of any kind regarding this software.  This software is
  186. distributed "AS IS" and the author will not be liable for any damages from use
  187. or misuse of the software.  ***
  188.  
  189. HotDIR Plus is $20 and comes with a registered version on disk, technical
  190. support from the author, notices of upgrades, and a software license showing
  191. you are a registered user.
  192.  
  193. Send registration payments directly to the author:
  194.  
  195. Robert Woeger
  196. 2423 Hagerman St.
  197. Colorado Springs, CO 80904-3228        (719) 471-8306
  198. U.S.A.
  199.  
  200. Write or call for info about site licenses, volume discounts, and repackaging
  201. HotDIR Plus with your software.
  202.  
  203. You may optionally register the $20 HotDIR Plus through Compuserve's
  204. Shareware Registration Service (GO SWREG) and using registration ID #364 for
  205. HotDIR Plus for DOS.  Your Compuserve account will be billed $20 and they will
  206. forward your order to me and I will send out your disk ASAP.
  207.  
  208. Note to Shareware Vendors:  You are free to distribute the complete HotDIR
  209. Plus package as long as you distribute unmodified copies and the complete
  210. package, and you only charge a disk duplication fee of less than $8.  CD-ROM
  211. vendors may distribute HotDIR Plus as long as the purchaser knows that
  212. HotDIR Plus is Shareware.
  213.  
  214.